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| Introduction 


This document describes the format of name sign template markup language as used in SW6000 in 
‘CAA| Setup| Configuration] Name sign templates’. 


The name sign template format used in SW6000 is in fact the render format directly understood by the 
rendering engine in the name sign hardware. In SW6000, though, the template is split into a “Front” and 
“Rear” definition for easier handling, and then merged into one before sending to a name sign. 


So a template in SW6000 is in its essence a name sign render J SON file for rendering the front and rear 
displays on a name sign. 


On top of the basic template definition SW6000 has a markup language which is embedded into the 
templates and which is evaluated by SW6000 when it renders the template for a specific name sign. 


In this way e.g. participant information can be merged into the predefined name sign template before it is 
sent to a name sign. 


What is covered in this document is the name sign template markup language defined for the CUI 
rendering of name sign content. 
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2 Template File 


This chapter describes all tags used in a template file. 


2.1 Object tags 


The purpose of this chapter is to describe display object tags 


me nme [Description [Bem O 


"BackgroundColor" 


"ForegroundColor" Optional 


number 


Optional 
number 


"Rotation" 


"Content" 


"Invert" Optional 


Boolean 


Optional 
text 


"Language" 


Color to use for global 
background. 
Default color: OxFFFFFFFF 


Color to use for global text 
rendering. 


Default color: OxFF000000 


Number describing the number 
of degrees the image is to be 
rotated. Current support degrees 
are 0 and 180. 

Default rotation is O. 


This array contains a description 
of the content to be rendered. 


If no content is available the 
screen is cleared. 


Each item in the array shall 
include a unique 'ID'. 


Note: Conditional statement can 
be used in the content as well. 
Refer to: '4 Conditional 
statements’ 


Flag to signal content is to be 
inverted. 
Default value "false" 


Language code (Locale Id). 


Specifies the SW6000 language, 
from where the data is collected. 


If no language code is specified 
or data is not available in the 
specified language, the ‘System 
language’ is used. 


If the resulting language code in 
use, is not included in the ‘MXC 

Global languages’ then the sign 

will use English (US), language 

code 1033. 


"BackgroundColor" : OxFFFFFFFF 
"Content" : 


gem 


"ForegroundColor" : OxNa000000, 
"Content" : 


| eee 


"Rotation" : 180, 
"Content" : 


[ 


"Content" : 


[ 


"ID" : 1, 
"Type": "TextBox", 


h 
{ 


"ID" : 2, 
"Type": "TextBox", 


"Invert" : true, 
"Content" : 


[s 


"Language" : "1034", 
"Content" : 


[ 


Number Identifies an object in the 
content array 
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This section describe objects which can be within a text box. 
Note: A text box do not show any borders. 


Tag Type Description 


"Type" Mandatory |Value must be "TextBox". 
string 


"Font" String containing name of font to 


use for text box. 


Default font is based on language 
configuration, set by "Language" 
tag. 


Overrides the default font. 


Optional Size of the font to use. 
number 


Default size is set to 72. 


Optional 
number 


X / Y start position of text box. 


Default X / Y position is set to 0. 
Position is calculated from upper 
left corner of the display 


"Width" 
"Height" 


Optional 
number 


Width / height of text box 


Default width is set to panel max 
width (1904). 
Default height is set to panel max 
height (464). 


Example 


"Content" : 
[ 
{ 
"ID" : 1, 
"Type": "TextBox", 


"Content" : 
[ 
{ 
"ID" : 1, 
"Type": "TextBox", 
"Font": "Kanit", 


"Content" : 


[ 


"ID" : 1, 
"Type": "TextBox", 
"Size": 130, 


"Content" : 
[ 
{ 
"ID" : 1, 
"Type": "TextBox", 
"Size": 130, 
"X": 0, 
"Y": O, 


"Content" : 
[ 
{ 
"ID": Ly 
"Type": "TextBox", 
"Size": 130, 
"X": 0, 
"Y": 0, 
"Width" : 1904, 
"Height" : 464, 
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Tag Description 


"AlignH" Horizontal / vertical alignment of | "Content" : 

"AlignV" text within the text box. [ 
If not set, "Center" value is used. { 
Valid horizontal values: "ID" : 1, 
"Left" "Type": "TextBox", 
"Right" "Size": 130, 
"Center" "X": 0, 
Valid vertical values: "Y": 0, 
"Top" "Width" : 1904, 
"Bottom" "Height" : 464, 
"Center" "AlignH": "Center", 


"AlignV": "Center", 


"Text" Mandatory |UTF8 Encoded text. "Content" : 
string The string can include a text [ 
and/or a ‘command’ from SW6000 | { 
to insert a value. "ID" : I; 
"Type": "TextBox", 
For 'commands' refer to '3.1 List "Size": 130, 


of commands "X": 0, 
"Y": O, 
"Width" : 1904, 
"Height" : 464, 
"AlignH": "Center", 
"AlignV": "Center", 
"Text": "@SeatA(ParticipantName)" } 


"BackgroundColor" Optional Color used to render background. "ID" : 1, 
number Overrides global "Type": "TextBox", 
"BackgroundColor" "BackgroundColor" : OxFFFFFFFF 
"ForegroundColor" Optional Color to render text with. "ID" : 1, 
number Overrides global "Type": "TextBox", 
"ForegroundColor" if used. "ForegroundColor" : OxFF000000, 
"Language" Optional Language code (Locale Id). "ID" : 1, 
text "Type": "TextBox", 
Specifies the SW6000 language, "Language" : “1033”, 


from where the data is collected. 


If a language code is not 
specified, the ‘Language’, which 
may be specified in ‘Object tag’ is 
used, else the ‘System language’ 
is used. 


If a language code is specified, 
but data is not available in that 
language, the ‘System language’ 
is used. 


Ifthe resulting language code in 
use, is not included in the ‘MXC 

Global languages’ then the sign 

will use English (US), language 

code 1033. 
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Description 


The language code ‘default’ is also "ID" :2, 
valid. "Type": "TextBox", 
"Language" : “default”, 


As the data to show is taken from | "Content" : 
the language data in SW6000, [ 
data in different languages, if { 

available, can be shown "ID" : 1, 
simultaneously in the sign. "Type": "TextBox", 


"Size": 100, 
In the example, the participant "Language" : "1033", 
name shown on the top is the "X": 0, 
English name and in the bottom "Y": 0, 
the Arabic name "Width" : 1904, 
"Height" : 232, 


"AlignH": "Center", 
"AlignV": "Center", 
"Text": "@SeatA(ParticipantName)" 


, 


AY 


"ID" : 2, 

"Type": "TextBox", 
"Size": 100, 
"Language" : "1025", 
"X": 0, 

"Y": 232, 

"Width" : 1904, 
"Height" : 232, 
"AlignH": "Center", 
"AlignV": "Center", 
"Text": "@SeatA(ParticipantName)" 


Specifies style of font. "ID" : 1, 
Valid values are: "Type": "TextBox", 
"Regular" "Style" : Bold, 


"Italic" 
"Bold" 
"Boldl talic" 
Default is "Regular". The font 
specified by "Font" must define a 
valid font for the style, or it will 
fall back to "Regular" 
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Comments 


The template format supports inserting comments using the following format: 


Description 


Used to insert comments or 
‘disable’ a line. 


Active until a line break. 


Used to insert comments or 
‘disable’ all in-between. 


"Content" : 
[ 


"ID" : 1, 

"Type": "TextBox", 
// "Font": “Kanit”, 
// This is a Thai font 


"Content" : 
[ 
[*1 
"ID" : 1, 
"Type": "TextBox", 


ie 
{ 


"ID" : 2, 
"Type": "TextBox", 


Important: Although the current template format supports inserting comments, this is not supported in 
standard json formats. This feature may be discontinued in future versions, and it is recommended to 


remove comments in the templates in use. 
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3 


Template Command Format 


The name sign template markup format rules: 


n 


All commands starts with an @-sign 

Command arguments are passed in a pair of parentheses directly after the command (i.e. no white 
spaces between command and arguments) 

If there are no arguments to the command, the argument parentheses can be omitted. 

If a @-character is required in the template, it must be typed in as “@@” - the template renderer 
will render that sequence as a single @-character in the output. 

Commands and arguments cannot span multiple lines. Both must be on the same line in the 
template. 


List of commands 


The markup language contains the following commands used for applying content. 


Command Description 


@SeatA Insert value from paired sets A 

@SeatB Insert value from paired seat B 

@Meeting Insert value from the started meeting 
@Sign Insert value from name sign configuration 


@Booth Insert value from booth configuration 


The following sections describes the commands in more detail. 
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The @SeatA/B commands are used for accessing information about the seat paired with the name sign as 


either A or B seat. 


The command takes one argument specifying which information to fetch from the seat 


Argument 


Data inserted when rendering 


Example 


SeatNumber 


The seat number of the paired 
seat 


"Text": “Seat @SeatA(SeatNumber)” 


“Seat 5” - providing the name sign has seat 5 as 
paired seat A 


ParticipantName 


ParticipantFirstName 


The full name of the participant 
of the paired seat 


The first name of the participant 
of the paired seat 


"Text": “@SeatB(ParticipantName)” 


“Peter Fessler” - providing the participant Peter 
Fessler is either logged in at, or assigned to, the seat 
paired as seat B on the name sign 


ParticipantLastName 


The last name of the participant 
of the paired seat 


ParticipantShowName 


The 'show name' of the 
participant of the paired seat. 
Show name is configured in 
'CAA| Setup| Meeting role’ 


ParticipantTitle 


ParticipantCustom1 
ParticipantCustom2 
ParticipantCustom3 


ParticipantCustom4 


The title of the participant of the 
paired seat 


The "User Table 1-4" value of the 
participant of the paired seat 


GroupName 


The group name of the 
participant of the paired seat 


GroupAbbreviation 


The abbreviated group name of 
the participant of the paired seat 


Message 


A message send to a participant 


"Text": "@SeatA(Message)" 


Most values in the table above refer to "the participant of the paired seat". This is the participant intended 
to be displayed on the name sign. First and foremost, this is the participant which is logged in at the seat. 
If no participant is logged in, and there is a seat assignment in the current meeting, the participant 
assigned to the seat will become "the participant of the paired seat", providing the participant is not 
currently logged in at another seat. 


If there is no participant for the paired seat, the participant-derived values will render as an empty string. 


All text values are fetched in the system default language for all name signs unless a font or a language 


code is specified. 
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Sign command 


The @Sign command is used to access information about the name sign itself. 


The command takes one argument specifying which information to fetch from the seat 


Argument 


Data inserted when rendering 


Example 


SerialNumber 


The serial number of the name sign 


"Text": “SerialNo: @Sign(SerialNumber)” 


“SerialNo: 164.214.045” - providing the serial 
number of the name sign is 164.214.045 


SeatA Seat number of the seat paired as A seat on "Text": "Seat @Sign(SeatA)" 
the name sign 
SeatB Seat number of the seat paired as B seat on "Text": "Seat @Sign(SeatB)" 


the name sign 


The @Meeting command is used to access information about the active meeting. 


The command takes one argument specifying which information to fetch from the seat 


Argument 


MeetingName 


Data inserted when rendering 


The name of the active meeting 


Example 


"Text": "@Meeting(MeetingName)" 


ActiveSubject 


The title of the active subject 


"Text": "@Meeting(Active subject)" 


) 


The @Booth command is used to access information about interpreter booth. 


The command takes one argument specifying which information to fetch from the booth. 


Argument Data inserted when Example 
rendering 
BoothLanguage The A language associated with 


a booth 


BoothLanguageAbbreviation 


Abbreviation for the A language 
associated with a booth 


BoothNumber 


The booth number 


"Text": "@Booth(BoothNumber) - 
@Booth(BoothLanguage) 
(@Booth(BoothLanguageAbbreviation) )" 


BoothLanguageChannel 


The number of the A channel 
associated with a booth 
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4 Conditional Statements 


The conditional statement can be achieved in two ways: 


e Conditional content in Text properties using @lf 
e Conditional JSON sections using “If” objects 


The following sections describes the conditional statements in details. 
4. Conditional content in Text properties using @lf 


The name sign conditional commands used as 'Text' arguments: 


e All commands starts with an @-sign 

e Command arguments are passed in a pair of parentheses directly after the command (i.e. no white 
spaces between command and arguments) 

e |fthere are no arguments to the command, the argument parentheses can be omitted. 

e If the first character after a command or command argument end parenthesis is a space, it is 
trimmed out when rendering a template. This allows the output of a markup command to line up 
with literal content in the template. (e.g. the template snippet “@lf(something) Yes@Else No" 
would evaluate to "Yes" or "No" when rendering - without skipping a space after a command it 
would yield "Yes" or " No", where No has a leading space, or would require empty parentheses 
after @Else to be able to put "No" right after the @Else to avoid the space) 

e |f a @-character is required in the template, it must be typed in as “@@” - the template renderer 
will render that sequence as a single @-character in the output. 

e Commands and arguments cannot span multiple lines. Both must be on the same line in the 
template. 


4.1.1 List of commands 
The markup language contains the following commands 


Command Description 

@lf Open a conditional section in the Text content 

@Else Open the alternative section of a conditional section in the Text content 
@Endl f Close a conditional section in the Text content 


1.1.2 @lf...@Else...@Endlf commands 
The @lf, @Else and @Endlf commands exists for conditional inclusion of sections in Text property values. 


Everything between an @lf and its associated @Else command is rendered to the name sign by the CUI 
only if the condition argument to the @If command is true. Otherwise, the section between the @Else and 
its associated @EndIf command is rendered to the name sign. 


The @Else command can be excluded, in which case the section between the (lf and @Endlf commands 
is rendered if the condition argument of the @If command is true. 


@lf..@Else..@Endlf constructs can be nested for complex conditional template content. 


The (lf command takes one of the following conditions as argument. 


12/20 


Shure Incorporated 


Argument Condition is true when 


SeatAHasParticipant The seat paired as name sign seat A has a participant assigned to it (i.e. a participant is to 
be displayed on the name sign) 


SeatBHasParticipant The seat paired as name sign seat B has a participant assigned to it (i.e. a participant is to 
be displayed on the name sign) 


The @Else and @EndIf commands take no arguments. 


| 


11.3 Example using (gf 


The following examples includes some JSON formatting, since the @If...@Else...@Endlf command syntax 
is designed to include or exclude chunks of text data in the template. 


Template snippet Output 
"Text": "@lf(SeatAHasParticipant) Participant A is here No one is here 
@lf(SeatBHasParticipant) with participant B If no participant is assigned to either 
@Endif paired seat A or B. 
@Else Participant A is here 


If a participant is assigned to paired 


@lf(SeatBHasParticipant) Participant B is here alone seat A and no one is assigned to paired 


@Else No one is here seat B. 
@Endlf Participant B is here alone 
@Endlf", If a participant is assigned to seat B 


and no one is assigned to seat A. 


Participant A is here with 
participant B 


If both seat A and B has assigned 
participants. 


| Notes on white spaces 


To limit the amount of data sent over the DCS LAN, the CUI will trim down the JSON of name sign 
templates. To save on processing this is done before the template is pre-parsed into literal text and 
markup commands. 


The trimming down of the JSON involves removing all non-quoted spaces and line breaks. This will affect 
how the markup language is parsed after the trimming. If, for instance, you have the construct "(Endlf 
This is my text" it will be trimmed down to "(EndlfThisl sMyText”, which will fail parsing, since there is no 
markup command named (EndlfThisl sMyText. 


A workaround for such a situation would be to include the optional parantheses on @Endlf. This would 
result in the trimmed down "(Endlf()Thisl SMyText", which is parsable. 
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| 


Command Description 

If Open a conditional section in the template 
Condition Specified the condition 

Then Open the conditional section in the template 

Else Open an optional conditional section in the template 


The condition command takes the same conditions as argument as the (glf command. 


Condition 


Condition is true when 


SeatAHasParticipant 


The seat paired as name sign seat A has a participant assigned to it (i.e. a participant is to 


be displayed on the name sign) 


SeatBHasParticipant 


The seat paired as name sign seat B has a participant assigned to it (i.e. a participant is to 


be displayed on the name sign) 


Example with 


‘If, then, else’ 
"Content" : 
[ 
"Type": "If", 
"Condition": "SeatAHasParticipant", 
"Then": 
[ 
{ 
"ID" : 1, 
"Type": "TextBox", 
"Size": 90, 
"X": 0, 
"Y": O, 
"Width" : 1904, 
"Height" : 230, 
"AlignH": "Left", 
"AlignV": "Center", 
"Text": "Seat A has participant" 
} 
iF 
"Else": 
[ 
1 
"ID" : 2, 
"Type": "TextBox", 
"Size": 90, 
"X": O, 
"Y": O, 
"Width" : 150, 
"Height" : 230, 
"AlignH": "Left", 
"AlignV": "Center", 
"Text": "Seat A has no participant" 
} 
] 
} 
] 


14/20 


Shure Incorporated 


The following template examples shown the two ways of using ‘If’ to constructs the display a "«" and “>” 


direction indicator if somebody is logged in at the A and B seat respectively, indicating the seating 


position of the displayed participant name. 


Achieved with @lf ... @Endif 


Achieved with "Type": "If" 
"Content" : 
[ 
1 
"Type": "If", 
"Condition": "SeatBHasParticipant", 
"Then": 
[ 
1 
"ID" : 1, 
"Type": "TextBox", 
"Size": 90, 
"X": 0, 
"Y": O, 
"Width" : 1904, 
"Height" : 230, 
"AlignH": "Left", 
"AlignV": "Center", 
"Text": "< @SeatB(ParticipantName)" 
} 
] 
Lh 
1 
"Type": "If", 
"Condition": "SeatAHasParticipant", 
"Then': 
[ 
1 
"ID" : 4, 
"Type": "TextBox", 
"Size": 90, 
"Font" : "Kanit", 
"X': 0, 
"Y": 230, 
"Width" : 1904, 
"Height" : 230, 
"AlignH": "Right", 
"AlignV": "Center", 
"Text": "@SeatA(ParticipantName) >" 
} 
] 
} 
] 


"Content" : 
[ 
{ 

"ID" : 1, 
"Type": "TextBox", 
"Size": 90, 
"X": 0, 
"Y": 0, 
"Width" : 1904, 
"Height" : 230, 
"AlignH": "Left", 
"AlignV": "Center", 


"Text": "@If(SeatBHasParticipant) < @SeatB(ParticipantName) @Endlf", 


Lh 
1 
"ID" : 4, 
"Type": "TextBox", 
"Size": 90, 
"Font" : "Kanit", 
"X": 0, 
"Y": 230, 
"Width" : 1904, 
"Height" : 230, 
"AlignH": "Right", 
"AlignV": "Center", 
"Text": "@lf(SeatAHasParticipant) @SeatA(ParticipantName) >@Endlf", 
} 


] 
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5 Fonts 


The font sizes supported are TTF fonts and all pt sizes are valid. 


If an invalid font is specified in a template, the “Roboto Condensed Regular” font will be used. 


5.1 
a! 
J, 


ported font 


The next table shows the fonts available in the Namesign. 


Font 


Regular 


Italic 


Bold Bold Italic 


Roboto 


x 


X x 


RobotoCondensed 
NotoSansThai 


x 


x 


Kanit 


NotoSansHebrew 


NotoSansC]K 


NotoSansArabic 


NotoNaskhArabic 


XX | >< | >< | >< | >< | >< | >< 


P ` 
global languages 


The table shows the default font selection for the MXC global languages. Each language is defined with a 
language code (locale id). 


Language code (Locale Id) Supported by font 
[Arabic 0025 
RobotoCondensed 


Chinese Simple 


| NotoNaskhArabic 


NotoSansC] K 


Kanit 


Thai 
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5.3 Fonts in use with SW6000 


When the MXCSIGN is used with SW6000 and the language(s) used in SW6000 is not supported in the 
MXC global languages, the MXCSIGN will use the Language code (Locale Id) 1033 (RobotoCondensed 
font). 


It is therefore not needed to change the 'Language' in any of the default templates in SW6000 if the used 
language is a language supported in the RobotoCondensed font. 


The Roboto and RobotoCondensed fonts support Latin, Greek and Cyrillic script and the following 
characters are supported: 


"#$% &'()* +,-./0123456789:; <=>? BABCDEFGHIJKLMNOPQRSTUVW 
xXYZI\]^_ ` abcdefghiikimnopgrstuvwxyzilh-id£nYis" OF a> © re 
HI, 12 >%wwrAW,AAAAAAACEEEEII(TIDNOOOOOxXxGUUUUYPRAAAAAA ec 
eééaiítióhóóó6ó-ogüuüüüybpyAaÁáAaCcécCeCccCéDbdbpaEeÉEéEeEeEéóGg Gd 
GggóáftihnniitifititingJjkkkLÍLILrE LEN NnNá nNpOoGO GO 6CEo RERrRTE 
op I a uc on i 
DOS IT 71U7T"ASCEHTOYQOÍIABFEAEZHOIKAMNzOnPZTYOxUOIYà£nibag 


v5gtnOikAuvEonpcoruoxuyoiüóüoorntE bL ESIIJJb I6 RKUYUABBTAEX 
34AKJAIMHONHPCTYoOXIIHUILlI bb b3lOosla6sergane»xsuü üKknMHOonpcrTydxu uu Wy 
a mee a aan equo ID CU 
Cox :WübbRnlrFrbsDK«3a3KKkKkKkKxHHHulbmGQoeccTTYvyYyXxTiuuuu 
hheeQeelXx6s7ZaHuHud s MnIASAa£oEBOoBsRRSiSsUnlnÓOOoÓSSSYyYUY 
jüüUrblüfrXxXxddd d uutda/UumHiuGoUsEc/IAAoMIh WWWWWWAaAaAdAASASA 


ó8ogUuDuUdgUrUgÜUQUuYyYyYyYy juegue ne n d NOLO tte Go MCW MEEPS d € 
96€ No'" e 36 5& 7$ 0 ]T] 3 - Vee [esa 0 fi fl ffi ffl 


Supported languages in Roboto and RobotoCondensed 
The following languages are fully or partly supported in Roboto and RobotoCondensed fonts: 


Afrikaans English Irish Rhaeto- Romanic 
Albanian Esperanto Italian Russian 
Bashkir Estonian Kayah li Scots 

Basque Faroese Kazakh Scottish Gaelic 
Belarusian Finnish Kurdish Southern Sami 
Breton French Latin Spanish 
Bulgarian Galician Leonese Swahili 
Catalan German Luxembourgish Swedish 
Chinese pinyin Greek Malay Tagalog 
Corsican Hungarian Manx Tatar 

Cyrillic Icelandic Norwegian Turkish 

Czech Indonesian Occitan Ukrainian 
Danish Internat. phonetic Polish Walloon 

Dutch Irish Portuguese Welsh 


5.4 Hebrew language 

Hebrew is not supported in the MXC global language, but Hebrew is supported in the MXCSIGN: 
Language Language code (Locale Id) Supported by font 
Hebrew 


To use Hebrew, the Hebrew language has to be specified in the Object tags or in a TextBox in the 
template. 
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6 Grey Colors 


6.1 format 


The name sign support 16 levels of grey colors. The color format used is OXAARRGGBB. 


AA - 8bit Alpha channel. 
RR - 8bit Red channel. 
GG - 8bit Green channel. 
BB - 8bit Blue channel 


Any color selected that do not support native colors will be converted to nearest grey and dithered. 


The JSON only accepts the Hex [A,R,G,B] and Decimal formats. 


6.2 Native colc 


ect Jue —— 
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7 Name Sign Specifications 


The MXCSIGN has the following specifications: 


Image Size 


1904 x 464 pixels 


Screen Dimensions 


380mm x 100 mm 


Thickness 


9mm 


Width x Height 


402mm x 113mm 


The positions and size of an item are specified in pixels. The position of an item is counted from upper left 


corner of the display. 


Font sizes are specified in pt. 
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